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PREFACE 


OVERVIEW 

FIX lets an advanced programmer get directly at several important areas of a diskette* 
Depending on the circumstances, FIX can sometimes help you recover some or all of your files 
from a "crashed" diskette* FIX lets youi (1) display directory entries, so that you know the 
exact entry for each file; (2) modify directory entries, so that you can control directory 
information; (3) trace sector chains through a file, looking for the end of the file or for a 
bad sector, so that you can verify the structure of a file! (4) check the allocation map, so 
that you can recover misallocated sectors; (5) modify sector links, so that you can control 
the file number, sector byte count, and forward sector pointer for any sector on the diskette 
and (6) edit actual sector data* 

This utility program is for an advanced systems programmer only* Its use requires a detailed 
understanding of disk structure* 


REQUIRED ACCESSORIES 
24K RAM 

ATARI 310 Disk Drive 

GETTING STARTED 

1* Turn on your disk drive, insert the DISK FIXER diskette, and power up your computer* 

2* When the READY prompt displays, type DOS to call up the menu* 

3* Enter menu selection L (Binary Load)* 

4* To the LOAD FROM WHAT FILE? prompt, enter FIXDMP and press the RETURN key* The file will 
load into RAM and start* 




bIX Reference Manual 


2 * 0 


I♦ INTRODUCTION TO FIX 


FIX is an assenbly language utility'to examine and Modify disk 
files* All nuMbers output by and entered to FIX are hexidecinal♦ 
You can use the CONTROL-1 key to start and stop the data display 
on the screen* 


II* FILE STRUCTURE 


Diskettes are divided into blocks of data called sectors* 
Diskettes for the ATARI S10 Disk Drive have 720 sectors of 128 
bytes* Diskettes for the ATARI 815 Dual Disk Drive have 720 
sectors of 256 bytes* Diskettes have four parts* 

1 ♦ BIT MAF* ♦ The bit Map contains inforwation on the status 
of each sector* By examining the bit Map* the File Manager 
can determine if a sector has been allocated (in use) or 
not (free)♦ 

2* DIRECTORY* The directory sectors contain infornation on 
the nanes* location#, length# and status of the files on a 
diskette * 

3* BOOT SECTORS* Each diskette contains one or three 
sectors reserved for infornation read on power-up* These 
sectors are nornally inaccessible to the user when using 
the File Manager* All 9/2*1/79 DOS diskettes use sector one 
for the boot* All DOS II 2S or 2D diskettes use sectors one 
through three* 

DATA SECTORS* The rest of the sectors are used to store 
the infornation in the files* Most of the bytes of a sector 
are dedicated to the actual file infornation* The last 
three bytes of every sector contain housekeeping 
infornation for the File Manager♦ 

FILES are nade up of a DIRECTORY ENTRY and a set of one or nore 
sectors* The sectors are usually contiguous# but do not have to 
be* For a conplete description of a directory entry* see section 
III*A* 
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III. MENU ITEMS 


FIX is a Menu-driven prograM. To execute coMMands, type the 
letter in front of the coMwand listed in the displayed Menu (see 
Figure 1). You needn't press the RETURN key? FIX autonatically 
accepts your coMMand, and it replies with the prowpt for that 
coMMand. If you inadvertently type the wrong coMMand, press the 
BREAK key to abort the coMMand. 

AJ_Directory Entries 

This Menu iteM displays the entries in the directory. Figure 2 
shows the user requesting FIX to display the first eight (hex) 
entries. Notice that the entries start with zero. The directory 
May contain a MaxinuM of 6^ files. Single entries May be 
displayed by siMply typing the file nunber and pressing the 
RETURN key. 

The leftMost eo'luMn gives the file nunber of each file 
displayed. The next colunn contains the file nane and extender. 
Notice that the period is oMitted in the file nane. The next 
colunn, labeled FSEC, is the first sector in the file. The #SEC 
colunn lists the nunber of sectors in the file. Both numbers are 
hexideci Mai.• 


The last colunn, DL, notes the status of the file. Notice in 
Figure 2 that file *1 (FIX6) has a D, Meaning the file has been 
deleted fron the directory. Because it is the first available 
"hole", the next file created will occupy its directory entry. 
File 3 (MYF'ROG.BAS) has an L, indicating the file is locked. 

Files 5-8 contain no directory entries. 


B 5 Trace Sector... C h a in 


This Menu iteM verifies the structure of a file. It traces the 
file through all its sectors until it hits an end-of-file or a 
bad.link. A link is a pointer to the next sector of a file. A 
bad link is a link to a sector belonging to another file. An 
end-of-file is a link pointing to sector 0. 

Figure 3 shows the sector chain for the snail BASIC file 
MYF'ROG.BAS. Notice we're tracing file number 3. The file number 
is the entry number into the directory. 
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Colunn BS has two different Meanings^ depending on the DOS that 
created the file* The 9/2^/7? DOS A used this number as the 
relative sector number* For the first sector in a file, this 
should be 1* Subsequent sectors should add 1 to this number* If 
you notice that nunbers are skipped,, this May indicate that the 
links in your file Might be bad* The last sector's BS is the 
nuMber of bytes in the sector* 

For DOS II, the BS indicates the nuMber of bytes in each sector* 
Most sectors contain $7D bytes (128-byte, single-density 
diskette) or $FD bytes (256-byte, double-density diskette)* The 
last sector in a file is usually less than the above nuMbers* 


Appending one file to another will cause the byte count in the 
sector between the appended portions to be less than full* It is 
therefore possible to have partially filled sectors in the 
Middle of a file* 


ColuMn FP is the forward pointer* This is the link to the next 
sector of the file* Files on newly forMatted diskettes tend to 
be linked sequentially* Files on diskettes with several files 
that have been deleted tend to becoMe fractured, Meaning that 
the files tend not to be linked sequentially* In other words, 
the sectors are not physically continguous* 


C* Modify Directory E n try 

Use this Menu iteM to Make changes to the diskette's directory* 
Enter the file nuMber of the entry you wish to change and press 
the RETURN key* 

Figure *1 shows the user is Making a change to directory entry 3* 
FIX has printed the directory iteM and positioned the cursor to 
the file naMe* 

At this point, you can edit the file nane, the starting sector 
nuMber, the nuMber of sectors, or the status of the file* Ely 
inserting or deleting the D, you can delete or reinstate the 
file* Ely adding or deleting the L, you can lock or unlock the 
file* See section III*A for the Meaning of the rest of the 
inforMation on the line* 

If you wish to have FIX update the entry, then press the RETURN 
key* If you don't want the entry updated, then press the BREAK 
key * 
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D t_ Check Al l ocati on hap 


This Menu iteM can recover sectors that have becone 
Misallocated♦ To run it, type D♦ FIX automatically starts Making 
its own bit Map* It will link through all the files and Mark all 
the sectors i n use and those that are free* FIX then c o m p a r e s 
its bit Map to the bit Map on the diskette* All sectors that 
should be free but aren't are printed as "MARKED IN USE"* All 
sectors that are really allocated to a file but aren't in the 
diskette's bit Map are m arked "FREE"* Sectors that are correctly 
allocated aren't printed* 


After FIX has checked all the sectors , it will, exit back to the 
Menu if all sectors are correct* If soMe sectors are 
Misallocated, it will ask you if you want to write its correct 
copy to the diskette* Type Y to do so* If you don't want the 
corrected bit Map to be written to the disk, then press the 
RETURN key* 


Figure 5 shows the result of a D coMMsnd* Notice that we had 
bad link in file 0 (the first file)* This will usually cause 
error code 16^ to display when you atteMpt to read the file* 
would probably want to trace its sector chain (B coMMand) to 
find the bad link* Our bit Map seeMS also to be slightly 
Mangled, so we would type Y to rewrite our new bit Map* 


a 

an 

We 



El Modify S e ctor L i nk 


You May have discovered that somc of your sector links have been 
altered incorrectly* This Menu iteM allows you to change the 
links in the sectors on the diskette* After you type E , FIX 
proMpts you to enter the sector nuMber to Modify* Enter the hex 
sector nuMber and press the RETURN key* 


FIX then prints the sector link inforMation froM the sector on 
the diskette* FIX positions the cursor on the line* Using the 
cursor control keys, you can alter the file nuMber this sector 
is allocated to, the nuMber of bytes in this sector of the file, 
and the forward pointer* Typing an E to the right of the forward 
pointer will Mark this sector as end-of-file* 


To tell FIX to write out the updated inforMation to the sector, 
press the RETURN key* If you realize you've Made an error in 
trying to Modify this sector, first position the cursor below 
the line and then press the RETURN key♦ FIX will then redisplay 
the line* Press the RETURN key to exit* 

See section III*B for More inforMation on the sector link 
display♦ 
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Ft _ Se t_ Drive Num ber 

This Menu iteM sets the disk drive nu«ber ♦ Type the disk drive 
nuMber (1 - 3) and press the RETURN key* Figure 7 shows a user 
setting the disk drive number to 1 (FIX defaults to disk drive 1 
upon loading)♦ 


G: Exit to DOS 


This iteM causes a return to DOS* 


Hi Dum p _Sect ors 

This iteM lets you exaMine sectors on the diskette* To look at a 
single sector, type the sector nuMber (in hex) and press the 
RETURN key* To look at several contiguous sectors, type the 
starting sector, a comms, and then the ending sector? then press 
the RETURN key* As the inforMation scrolls up the screen, use 
CTRL-1 to stop and resume the display (that is, hold down the 
CTRL key while pressing 1)* 

Figure 8 shows a typical duMP of a 128-byte sector* The sector 
links for this sector are at the top of the screen (see section 
III*8)* The bytes in the sector are displayed in an Q-by-16 
Matrix in both hex and ATASCII* The leftMost colunn is the 
position of the next coluMn's byte in the sector* 
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It Edit Sector 


This iteM lets you examine and Modify a single sector on the 
diskette. In response to the proMpt. enter the sector nunber (in 
hex) and press the RETURN key. FIX will then display a full 
128-byte sector or the first half of a 256-byte sector siMilarly 
to the H option. To edit the sector, position the cursor on the 
line to be Modified. Notice that in the left-hand colunn the hex 
position of the byte in the next colu m n is displayed. Use these 
nuMbers to guide you in editing lines. You can edit only the hex 
bytes in the sector display. The ASCII characters are for 
reference only. 

After editing a line, press the RETURN key. FIX will then 
redisplay the sector (or sector part) with your Modifications. 
After you've finished editing, press the BREAK key. FIX will ask 
you if you wish to write the Modified sector to the diskette. To 
do so. press the Y key. Press any other key to cause FIX to ask 
you if you wish to exit. Press the Y key to return to the Menu 
without changing this sector on the diskette. Or. to cause FIX 
to ask you whether you want to write this sector to another 
sector, press any key other than Y. Then type in the riUMber of 
the sector to which you want FIX to write this sector♦ Or. press 
the RETURN key to redisplay the proMpt to exit. 

Editing a 256-byte sector differs slightly froM editing a 
128-byte sector, described above. FIX displays the first half of 
the sector (bytes 0 - 7F hex). You edit this part as described. 
Pressing the BREAK key after editing the first part of the 
sector lets you edit the second part (bytes 80 - FF). You then 
press the BREAK key again for FIX to ask you if you want to 
write the sector, exit, and so on. 

Figure 9 shows the editing of sector 5. The display reseMbles 
that for the H coMMand. We Modify sector 5 and then press the 
BREAK key. We respond to the two proMpts by pressing the RETURN 
key. because we wish to write our edited sector to sector 8. We 
then type 8 <RETURN> and FIX writes the edited sector to sector 
8 . 
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IV. ERROR CODES AND RECOVERY 


ERROR # DESCRIPTION 

>K>K>K>K)K)XX<>K>K>K>K>K>K)KttX(>K>K>K)OC>K)K>K:OX>K>K>K>K>K)K*)K& 

128 BREAK KEY ABORT 

This is caused by pressing the BREAK key. 

129 IOCB ALREADY OPEN 
The 10CEi is already open. 

Recovery ♦ You can CLOSE the IOCB and reOPEN it. You can use 
the current IOCB. You nay want to check to see why the IOCB is 
OPEN . 

130 NON EXISTENT DEVICE 

You have tried to access a device not in the handler table, 
i.e.. the device is undefined. The handler May be loaded in 
Memory but not initialized. This error May occur when trying t 
access the ATARI 850 Interface Module without running the RS23 
AUTORUN.SYS file. 

Recov ery ♦ Check your I/O coMnand for the correct device, or 
load and initialize the correct handler. 

131 IOCB WRITE ONLY ERROR 

You have attempted to read from a file opened for write only. 
Recovery ♦ Open the file for read or read/write (update mode). 

132 ILLEGAL HANDLER COMMAND 
This is a CIO error code. The command code passed to the device 
handler is illegal. The command is either less than or equal to 
2 or is a special command to a handler that hasn't implemented 
any special commands. 

Recovery ♦ Check your XIO or IOCE'. command code for illegal code. 

133 DEVICE/FILE NOT OPEN 

Device or file not open. You haven't QPENed this file or device. 
Recover y♦ Check your OPEN statement or file I/O statement for 
the wrong file specification. 

13* INVALID IOCB NUMBER 

You've tried to use an illegal IOCB index. For BASIC, the range 
is 1 - 7. BASIC doesn't allow use of IOCE! 0. The Assembler 
Editor Cartridge requires the IOCE*! index to be a multiple of 16 
and to be less than 128. 

135 IOCB WRITE ONLY ERROR 

You've tried to write to a device/file that is OPEN for read 
only. Recovery ♦ You could open the file for write or for 
read/write. 

136 END OF FILE 
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Your input file is at end—of— file♦ No More data is in the file* 

137 TRUNCATED RECORD 

This error typically occurs when the record you're reading is 
larger than the MaxiMUM record size specified in the call to 
CIO* BASIC's Maxi mum record size is 119 bytes* 

Recover y ♦ You probably are trying to use an INPUT 

(record-oriented) co mm and on a fi1e that was created using PUT 
< byte-oriented) coMMands♦ 

Records in a file are deliMited by EOL. (End Of Line) characters 
($9B) ♦ Files created using PLJTs have no EOL unless the bytes you 
output have a $9B* Trying to read a PUT file with record I/O May 
cause the DOS to read a record the size of the file* The DOS 
will then generate this error* Try reading the file using PUT 
stateMents♦ 

This error May also o c c u r when E N TE Rin g a B A SIC p r o g r a m created 
using SAVE* Try LOADing the prograM* 

138 DEVICE TIMEOUT 

A coMMand was sent by the coMputer to a device over the serial 
bus* The device didn't respond within the period set by the 
Operating SysteM (OS) for that particular device coMMand* This 
error can be caused in a couple of ways* 

1* The device nuMber May be wrong* For exaMple* the coMMand 
OPEN #3 > ^ >0 t "D3 J MYPROG" 

could cause this error to display if disk drive 3 isn't 
connected to the coMputer > turned on, or present* 

2* The disk drive May be present but is unable to execute the 
coMMand in the proper period of tiMe* 

Rec o ver y* To recover froM error case 1, exaMine the 
connections between the disk drive and the coMputer to Make sure 
they're properly secured* Check the drive to Make sure it's 
powered on and set for the correct drive nuMber* Check your I/O 
coMMand for the correct drive nuMber♦ Retry the coMMand* If you 
get this error again f try the recovery technique for the second 
error case* The second type of ti m eout error is caused by an 
interaction between the OS and the disk drive* DOS 9/2^/79's 
tiMeout value was set too low for all possible cases of disk 
operations* The disk May have had sane trouble executing the 
coMMand in the short period allowed by the operating systen* DOS 
II doesn't have this problem* This type of tiMeout error is 
inter m:L ttent ♦ You should be able to retry the operation and 
succeed* If this error occurs More than a few t i m e s > the device 
May need repair* 
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139 DEVICE NAK 

This is a catch-all error code* The device nay have received a 
valid command, but can't execute it because of bad 

parameters-—for example, trying to read an unaddressable sector, 
such as sector 0* Or* the device nay have received a garbled 
command or data frame from the computer* 

Re cove ry♦ Check your I/O command for illegal parameters* 

140 SERIAL FRAME ERROR 

Bit 7 of SKSTAT in POKEY is set* This means communications from 
the device to the computer are garbled* Specifically, POKEY 
detected missing or extra bits in a byte received on the serial 
data bus* 

141 CURSOR OUTRANGE 

Your cursor is out of range for this particular graphics mode* 

142 SERIAL OVERRUN 

Bit 5 of SKSTAT in POKEY is set* The computer didn't respond 
fast enough to a serial bus input interrupt* POKEY received 
another 8-bit word on the serial bus before the computer could 
process the previous word received* 

Recov ery * This is a rare error* If it recurs, you should have 
your computer serviced* 

143 CHECKSUM ERROR 

Serial bus communications are confused* The checksum sent by the 
device isn't the same as that calculated from the frame received 
by the computer ♦ 

Recovery * You can't do much about this* It could be a hardware 
or a software problem in the device/computer* 

144 DEVICE DONE ERROR 

The device can't execute a valid command* This error has two 
causes* Usually it means you've tried to write to a 
write-protected device or diskette* This is easily corrected by 
removing the diskette protect tab or by turning off the 
write-protect switch on the ATARI 815* 

The second reason for this error appears unknown at this point* 
The disk drive is unable to read/write the sector requested or 
the cassette is set at the wrong baud rate* 

Recovery * Remove the write-protect tab or turn off the 
write-protect switch* If the diskette wasn't write-protected, 
you might have problems with the diskette media* (I don't know 
how to recover on cassette*) 
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145 


READ AFTER WRITE COMPARE ERROR 

You've tried to open the SCREEN EDITOR with an illegal graphics 
node nuMber ♦ 

Re cov ery♦ Check GRAPHICS node call or the AUX2 byte in the 

ioce* 


146 FUNCTION NOT IMPLEMENTED 

Function not inplenented in handler t c♦9 ♦* trying to PUT to the 
keyboard or issuing special connands to the keyboard* 

Rec overs ♦ Check your I/O connand for the right connand to the 
correct device* 


147 NOT ENOUGH RAM FOR SELECTED GRAPHICS MODE 

You don't have sufficient RAM installed for the selected 
graphics node* 

Reco ve ry * Add nore nenory or use a snaller graphics node* 

160 DRIVE NUMBER ERROR 

You specified an out-of-range drive (not 1 - 8) or you haven't 
allocated a buffer for this drive* 

R ecover y ♦ Check your file specification or byte 1802 ($710)* 

161 TOO MANY OPEN FILES 

You don't have any free sector buffers to use on another file* 
Recovery * You nay have up to 8 open files* Check location 1801 
($709) for the nunber of sector buffers allocated* 


162 DISK FULL 

You don't have any nore free sectors on this diskette* This 
error occurs when writing to a full diskette* 

Recovery ♦ Use a different diskette with free sectors* Use the 
D option on FIX to see if you've niseilocated sectors* At 
present* you can't recover fron this error during progran 
execution♦ 

163 FATAL SYSTEM I/O ERROR 

This error code neans the Fi1e Manager has a bug in it* If you 
get this error* please report it to CUSTOMER SERVICE 
(800/538-8547* or 800/672-1430 for calls within California)* 

164 FILE NUMBER MISMATCH 

The structure of the file is Managed* One of the file links 
points to a sector allocated to another file* 

Recovery ♦ Use Ei arid E FIX connands to fix up the file 1 inks ♦ 
You can't recover fron this error during progran execution* 

165 FILENAME ERROR 

Your file specification has illegal characters in it* Legal 
characters are alphanunerics* * * and ?♦ 

R ecove ry * Check your file specification and renove illegal 
characters♦ 


-10 



FIX Reference Manual 2♦0 


166 POINT DATA LENGTH 

The byte count in the POINT call was greater than 125 
(single-density) or 253 (double-density)* 

Recovery ♦ Check POINT statement parameters* 

167 FILE LOCKED 

You've tried to access a locked file* 

Recovery♦ Un1 o ck the file* 

168 DEMICE COMMAND INVALID 

This probably means the device didn't recognize the command* 
R ecov ery♦ ? ? ? ? ? 

169 DIRECTORY FULL 

You don't have any free entries in the directory* 

Re co very♦ See A and C FIX commands* 

170 FILE NOT FOUND 

You've tried to access a file that doesn't exist in the 
diskette's directory* 

R ecove ry♦ Usually you've mistyped the file specification* 

Using the DOS A command* look at the directory for the correct 
name ♦ 

171 POINT INVALID 

You've probably tried to POINT to a byte or record beyond the 
end of the file* 

Rec o very ♦ Check the size of the file against the POINT value* 

172 ILLEGAL APPEND 

You've tried to OPEN a DOS I file for append using DOS II* DOS 
II can't append to DOS I files* 

Recovery ♦ Copy the, DOS I file to a DOS II diskette* using DOS 

ii* 

173 BAD SECTORS AT FORMAT 

The disk controller detected bad sectors while formatting a 
diskette* 

Rec over y♦ Throw away the diskette and use another* If you 
can't format a diskette* the disk drive might need repair* 
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FIXDUMP 2.OSD (C) ATARI 10/3/1980 

At DIRECTORY ENTRIES Ht DUMP SECTORS 
B t TRACE SECTOR CHAIN It EDIT SECTOR 
Ct MODIFY DIRECTORY ENTRY 
Dt CHECK ALLOCATION MAP 
Et MODIFY SECTOR LINK 
Ft SET DRIVE NUMBER 
Gt EXIT TO DOS 


SELECT ITEM OR 


Figure 1* Disk 


SELECT ITEM OR 
FIRST t LAST DIR 
0 , 8 

D# FILENAM EXT 
00 DOS SYS 

01 DUP SYS 

02 FIX6 

03 MYPROG BAS 
04 FIX6 
05 

06 ##*######## 
0 7 #««««*# 
0 8 


SELECT ITEM OR 


RETURN 

FOR MENU 

F ixer 

Menu 


RETURN FOR 

MENU 

ENTRIES TO 

SHOW? 

FSEC 

#8 EC 

DL 

0 0(M 

0 0 26 


0 0 2A 

0 0 2A 


005^ 

0 0 2A 


OOZE 

0 0 03 

L 

005^ 

0020 

D 

0 0 0 0 

0 00 0 


0 0 0 0 

0 0 0 0 


0 0 0 0 

0 000 


0 0 0 0 

0 0 00 


RETURN FOR 

: MENU 


Figure 


Option At Directory of Entries 
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SELECT ITEM OR RETURN FOR MENU 
TRACE FROM WHAT DIR ENTRY? 

3 


03 MYPROG B 

IAS 

007E 0003 

L 


SECTOR 

oze: 

F# = 

03, BS-7D, 

FP-07F 


SECTOR 

07f: 

F# = 

03, B S = 7 D, 

FP=080 


SECTOR 

080 : 

F # = 

03, BS=45, 

FP-00 0 

E 

SELECT 

ITEM 

OR 

RETURN FOR 

MENU 


Figure 

3* Option B: Trace 

Sector 

Chain 

SELECT 

ITEM 

OR 

RETURN FOR 

MENU 


WHICH 

ENTRY 

TO 

MODIFY? 




3 

D# FILENAM EXT FSEC #SEC DL 
03 MYPROG BAS OOZE 0 0 03 L. 


Figure ^ ♦ Option Cl Modify Directory Entry 


SELECT ITEM OR RET URN FOR MENU 
BUILDING ALLOCATION MAP♦♦♦ 


BAD LINK IN FILE # 
SECTOR 001: F # = 0 0 , 
WAS MARKED IN USE 
SECTOR 00^: F#=0Q, 
WAS MARKED FREE 
SECTOR 0 07 : F # = 0 0, 
WAS MARKED IN USE 
SECTOR 02A: F#=01, 
WAS MARKED FREE 
SECTOR 02C: F#=01, 
WAS MARKED FREE 
SECTOR 032: F*=Q1, 
WAS MARKED FREE 


Fig u r e 5♦ Option D 
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FP=02B 

BS=7D, 
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F P = 0 3 3 


Check Allocation Map 
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FIX Reference Manual 2.0 


SELECT ITEM OR RETURN FOR MENU 
MODIFY LINK OF WHAT SECTOR? 

80 

SECTOR 080: F#=03, BS=45» FP=00Q E 


Figure 6. Option Et Modify Sector Link 


SELECT ITEM OF R ETURN FOR MENU 
USE WHAT DRIVE NUMBER? 
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SELECT ITEM OR RETURN FOR MENU 

Figure 7. Option Ft Set Drive Number 
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SELECT ITEM OR RETURN FOR MENU 


Figure 3* 


Option Hi 


Dump Sect or s 
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SELECT ITEM OR RETURN FOR MENU 
ENTER HEX DISK SECTOR TO EDIT 
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TYPE BRK TO EXIT 

TYPE "Y" TO WRITE SECTOR 
TYPE "Y" TO EXIT 

ENTER HEX SECTOR TO WRITE BUFFER TO 
8 _ 


Figure 9. Option It Edit Sector 
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